home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / misc / zx-spectrum471.lha / Doc's / ZX-Spectrum.doc < prev   
Encoding:
Text File  |  1994-11-23  |  9.7 KB  |  226 lines
  1. ZX-Spectrum emulator v4.7pb 680x0 (c) 89-93,94 Jeroen Kwast
  2.  
  3. Author:    Jeroen Kwast
  4.   Grevelingenstraat 126
  5.     1784 HX Den Helder
  6.     Holland
  7.     
  8. E-MAIL: v892313@multatuli.si.hhs.nl from aug-89 'til jul-91
  9.     jeroenkw@solist.htsa.aha.nl from aug-91
  10.     jeroenkw@htsa.hva.nl from aug-94
  11.  
  12. --------------------------------------------------------------------------
  13.  
  14. ***************************************************************************
  15. *                                                                         *
  16. * V4.0 IS THE FIRST RELEASE OF THIS EMULATOR, EARLIER VERSIONS WERE DEMO  *
  17. * VERSIONS AND WERE NOT RELEASED BY THE AUTHOR !!!                        *
  18. *                                                                         *
  19. * This Emulatorv4.0pb is ShareWare. This version must contain:            *
  20. * the Emulator along with this file and the example programs in the       *
  21. * Progs/ directory. Only the main rom file "TheRom.z80" is included in    *
  22. * this version. The other roms (Interface 1/Opus/Multiface) are NOT       *
  23. * included. Only the main rom may be used in emulators like this. Thank   *
  24. * you Amstrad for releasing the rom to be used in my emulator.            *
  25. * The other rom files must be obtained separatly as described             *
  26. * below and may NOT be copied with the Emulator should you obtain them !! *
  27. * If you use this program and you feel that you like this program or you  *
  28. * would like to see something changed/added, please write to the address  *
  29. * above. If you would like to have future updates of this program         *
  30. * please write to me as above or use my E-MAIL address.                   *
  31. * If you would contribute to my efforts you can send me $10 dollars       *
  32. * or any other currency that is equivalent to $10 dollar.(in banknotes)   *
  33. * This automaticly makes you a listed ShareWare user and you will get     *
  34. * ALL later versions of the Emulator. You may also ask me any questions   *
  35. * about the Emulator or suggest some improvements. If you write to me you *
  36. * must include your own address otherwise I can't send you my answer. If  *
  37. * you want to become a registered user and you have a E-Mail address you  *
  38. * can first send me a message to my E-Mail address before you send some-  *
  39. * thing to my physical address. I'd be happy to answer any questions      *
  40. * before you decide. If you don't have access to E-Mail you'll have to    *
  41. * send me a letter to my physical address. I hope you enjoy this          *
  42. * program as much as I do,                                                *
  43. *                                                                         *
  44. *                           Jeroen J. Kwast. jeroenkw@htsa.hva.nl         *
  45. *                                                                         *
  46. ***************************************************************************
  47.  
  48.  
  49. The Emulator.
  50.  
  51. This emulator enables you to run almost any program that runs
  52. on a ZX-Spectrum. If you find that a program won't run at all
  53. please write to me which program caused this under what
  54. circumstances so it may be corrected in future versions.
  55. (This may result in a free registration so include address)
  56.  
  57. NOTE: I presume you know how the ZX-Spectrum works. This means
  58.       that you know how to load/save programs and run them as
  59.       described in the ZX-Spectrum user manual as well as some
  60.       other 'simple' operations. 
  61.  
  62.  
  63. Loading Programs.
  64.  
  65. If you want to load a program you can either load it from disk
  66. or load it from tape. If you have created a program with the
  67. emulator you can simply use the SAVE filename command and your program
  68. will be saved in the ZX-Spectrum:Progs/filename directory. If you
  69. want to reload it later you just use the LOAD filename command and
  70. the emulator will load your file back into memory.
  71.  
  72.  
  73. ROMS.
  74.  
  75. The Interface I Rom .. If you have an Interface I you can use the
  76. ser: port to load it into your Amiga some way. If you used to be a
  77. clever ZX-Spectrum user you will figure some way out to load it as well.
  78. The main Rom is called:TheROM.z80 and the InterfaceI Rom is called 
  79. Shadow.z80. They must be present in the ZX-Spectrum: directory before
  80. you start the emulator.
  81.  
  82.  
  83. Getting Started.
  84.  
  85. Insert the disk into the internal drive and after a while you get
  86. the familiair (c) notice. 
  87.  
  88. Keyboard: All keys are the same as if it where a ZX-Spectrum exept,
  89.  
  90. ESC   : Reset ZX-Spectrum
  91. `     : EDIT
  92. TAB   : E-MODE
  93. CTRL  : G-MODE
  94. LSHIFT: CAPS-SHIFT
  95. RSHIFT: SYMBOL-SHIFT
  96. HELP  : HELP-PAGE
  97. F1    : SNAPSHOT-MODE
  98. F2    : PRINTSCREEN-MODE
  99. F3    : RE-LOAD ROM
  100. F4    : NMI
  101. F10   : EXIT Emulator
  102.  
  103. Help page.
  104.  
  105. If you press help you get a new screen with some options displayed.
  106. Let's go over them one by one,
  107.  
  108. First you get the version number,the processortype it's currently
  109. running under and a p for processor or a b for blitter version.
  110.  
  111. 1 ... Load rom on reset, if you press ESC or enter rand usr 0 the
  112. rom file will be reloaded. This is usefull if you have changed the
  113. rom and you made a mistake or if some program destroys the rom. (because
  114. offcourse it's actually ram) Press 1 to toggle Y/N.
  115.  
  116. 2 ... Interrupts/Second, with this you can tell the emulator how many
  117. interrupts will occur in 1 second. The ZX-Spectrum does this 50 times/sec
  118. but on slow Amiga's this will overflow the stack sometimes and the program
  119. will crash. Use a lower count if this occurs. you can choose from 1,5,10,
  120. 25 and 50 Ints/Sec. Press 2 to toggle.
  121.  
  122. 3 ... ROM write protect, this one's easy. If you don't want to write in
  123. the rom, use this option to write protect your rom. Press 3 to toggle Y/N.
  124.  
  125. 4 ... HALT Emulation, On slow Amiga's some programs/games use the Z80
  126. halt instruction and this slows the speed down considerably. Press 4 to
  127. emulate the halt instruction or ignore it.
  128.  
  129. 5 ... Load from tape, Normally if you use the LOAD command, you will
  130. load from disk. In the Progs/ directory. But if you toggle it yo Yes
  131. the LOAD command will now load from tape. This means that you have
  132. to have a sound sampler connected to you par. port and a spectrum
  133. program ready on a tape. On a 68000/7MHz you will have no trouble
  134. loading a file into the Emulator. You can even use a copy program
  135. to load from tape and automaticly save to disk. I used it and it works
  136. great. Press 5 to toggle Y/N. I'm rewriting the tape loader/saver so
  137. I temporarily put back the old one for this DEMO version.
  138.  
  139. 6 ... Interface I emu. on/off, If you have a Interface I you know that
  140. some programs can have extended commands and extended file handling.
  141. If you have such programs and want to run them on the Emulator
  142. you can Press 6 to toggle the emulation on/off.
  143. ** If you get a star * instead of Y/N you have an enhanced version. This
  144. means that this function can NOT be changed. To swap between Interface I
  145. emulation and a standard emulation you'll have to use the dedicated versions.
  146. This was done because many people with a 68000 asked me to speed things
  147. up. This method increases the emulation by 15%. Now it emulates at about
  148. 35-40% on a plain 68000 based amiga. 
  149.  
  150. 0 ... Save preferences, Ones you've ajusted all prefs you can save them
  151. to disk so that the next time you load the Emulator, the preferences
  152. will be re-loaded from disk. If you want to use the defaults values
  153. after you saved the prefs, you simply delete the ZX-Spectrum.prefs file
  154. and load the Emulator. This will set the prefs to their default values. 
  155.  
  156.  
  157. Program directory.
  158.  
  159. In the ZX-Spectrum:Progs/ directory, all files will be saved.
  160. To catalogue them: I've used a fastdir system. There is a file
  161. called .cat in this directory and it contains all other files
  162. in this directory. If you have say .. 200 small files on a disk
  163. it will only load the .cat file. This is much faster. You can look
  164. into the catalogue by using the CAT command.
  165.  
  166. if you use CAT you get all the files on the disk.
  167. if you use CAT * you get all the information about the file.
  168.  
  169. you can also specify what you want to see:
  170. p - for programs
  171. c - for code
  172. $ - for string array files
  173. n - for number array files
  174. s - for snapshot files
  175.  
  176. NOTE: If you copy some files into the Progs dir in the CLI you must
  177.       DELETE the .cat file so that the Emulator will create a new
  178.       file with the new files! Will be fixed soon.
  179.  
  180.  
  181. Snapshots.
  182.  
  183. You can create a snapshot of the program/game you're currently running
  184. by pressing F1. You will get a message if you're sure. If you press Y
  185. you must enter a name. (A null name will abort) If you press enter
  186. it will save a snapshot file of the memory in the Progs directory.
  187. You can now run this snapshot by just entering LOAD snapshotfilename
  188. <RETURN>. and the program will continue where it was interrupted.
  189. If you get the question IFF or RAW? choose RAW. The IFF file format
  190. is not yet finished so I just use my IFF format. As soon as all the
  191. people around the world that are working on a emulator agree, it will
  192. be correct.
  193.  
  194.  
  195. Printing screens.
  196.  
  197. If you have a printer connected and using a epsontype driver you can press
  198. F2 to dump the current screen image on the printer. If you have a
  199. processor greater than 68000 you must be sure to have your cache turned
  200. OFF because otherwise this function will not work. I wanted the Emulator
  201. to run on a 68000 to a 68040 so turn it off before running the Emulator.
  202.  
  203.  
  204. Pressing F3 will reload the rom and continue. This is usefull if you're
  205. running a debugger and changed something that will crash basic but not 
  206. the debugger.
  207.  
  208. Pressing F4 will cause a Z80 NMI to be generated. Might be usefull for some
  209. people. I used it in one of my roms.
  210.  
  211. Press F10 to exit the Emulator.
  212.  
  213. Finally, If you have any questions or bugs to report please mail them
  214. to my current E-MAIL address: jeroenkw@htsa.hva.nl
  215. or write them to my physical address shown above.
  216.  
  217. ---------------------------------------------------------------------------
  218.  
  219.                         Jeroen J. Kwast (MM)
  220.  
  221. On a dark day Magicus.M said to me ...
  222.  
  223.             "It is better to create an illusion of life,
  224.              then live to create illusions."
  225.              
  226.